home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / visulztn / lise / minilise.lha / minilise / Read_Me_First,Really < prev    next >
Text File  |  1993-03-31  |  10KB  |  324 lines
  1. I. Copyleft
  2. -----------
  3.    Copyleft (C) 1990 - 1993 Rainer Kowallik.
  4.  
  5. This file is part of LISE.
  6.  
  7. LISE is distributed in the hope that it will be useful, but
  8. WITHOUT ANY WARRANTY.  No author or distributor accepts responsibility
  9. to anyone for the consequences of using it or for whether it serves any
  10. particular purpose or works at all, unless he says so in writing.  Refer
  11. to the LISE General Public License for full details.
  12.  
  13. Everyone is granted permission to copy, modify and redistribute
  14. LISE, but only under the conditions described in the LISE
  15. General Public License.  A copy of this license is supposed to have been
  16. given to you along with LISE so you can know your rights and
  17. responsibilities.  It should be in a file named COPYING.  Among other
  18. things, the copyright notice and this notice must be preserved on all
  19. copies.
  20.  
  21. II. What for ?
  22. --------------
  23.  
  24. LISE stands for on Line Interactive Spectra Examination.
  25. It is a relatively complete collection of routins to
  26. display, modify, and fit one dimensional spectra.
  27. There is virtually no limit on the size of the spectra.
  28. LISE is intended to work on commandline oriented
  29. multitasking machines, such as UNIX Workstations
  30. and the AMIGA series of computers.
  31. There is also a Graphical User Interface available for
  32. LISE applications. This GUI is based on my
  33. Menu Description Language Interpreter MDL. MDL itself
  34. is not part oft this distribution, but is available
  35. as Public Domain Programm too. The UNIX MDL needs
  36. the OSF Motif toolkit to be installed properly.
  37. (The Amiga Version runs on any Amiga, even with WB 1.3)
  38. All Distributed MDL scripts have names "*.mdl"
  39.  
  40. III. Files in this Distribution
  41. -------------------------------
  42.  
  43. 1. Graphical primitives
  44.  
  45.    ash.c
  46.    cur.c
  47.    hco.c
  48.    rmtek.c
  49.    pag.c
  50.    point.c
  51.    tekamiga.c
  52.    tekdaemon.c
  53.    tpo.c
  54.    tsf.c
  55.    vect.c
  56.  
  57. 2. spectra manipulation
  58.  
  59.    cio.c
  60.    genspc.c
  61.    lbn.c
  62.    mspc.c
  63.    scalc.c
  64.    stype.c
  65.    tcal.c
  66.  
  67. 3. spectra analysis / fitting
  68.  
  69.    b_hf.c
  70.    expfit.c
  71.    four.c
  72.    fpeak.c
  73.    fprompt.c
  74.    linFIT.c
  75.    linfit2.c
  76.    nmrrvt.c
  77.    rvt.c
  78.    rvt2.c
  79.    pacsplit.c
  80.    fit/ExampleFn.c
  81.    fit/fit.c
  82.    fit/FitFnWkk.c
  83.    fit/read_table.c
  84.    fit/Example.prm
  85.    fit/fit.prm
  86.    fit/FitFnWkk.prm
  87.    fit/test.prm
  88.  
  89. 4. string handling
  90.  
  91.    str/getline.c
  92.    str/instr.c
  93.    str/line.c
  94.    str/midstr.c
  95.    str/param.c
  96.    str/strhead.c
  97.    str/strlen.c
  98.    str/strtail.c
  99.  
  100. 5. Menu files (for MDL)
  101.  
  102.    ExpFit.mdl
  103.    lise.mdl
  104.    lisemod.mdl
  105.    LisePrompt.mdl
  106.    LiseRvt.mdl
  107.    specdef.mdl
  108.    xfit.mdl
  109.  
  110. 6. make files
  111.  
  112.    mklise | mklise.sh      compile individual files
  113.    mkall  | mkall.sh       compile all files
  114.  
  115. 7. miscellaneaous
  116.  
  117.    auxcfg.h
  118.    gfx.h
  119.    gfxamiga.h
  120.    spec.h
  121.    strings.h
  122.    ccalc.c
  123.    COPYING
  124.    Read_Me_First,Really
  125.    lise.doc
  126.  
  127.  
  128.  
  129. IV. Installation
  130. ----------------
  131.  
  132. a. What do you need for a first example ?
  133.  
  134.    UNIX version                     Amiga Version
  135.   - The minimum consists of the following programms:
  136.                                     Cshell (not part of the package)
  137.    tekdaemon                        TekAmiga
  138.    ash                              ash
  139.    scalc                            scalc
  140.    tekon                            tekon
  141.    rmtek                            rmtek
  142.   - and the following settings:
  143.    LISEPRG=/src/lise                Assign LISE: sys:lise
  144.   - the following datafiles:
  145.    $LISEPRG/Aux_Config              LISE:Aux_Config
  146.    $LISEPRG/fonts/sans.chr          LISE:fonts/sans.chr
  147.    $LISEPRG/fonts/trip.chr          LISE:fonts/trip.chr
  148.    $LISEPRG/fonts/symb.chr          LISE:fonts/symb.chr
  149.   - and the execution path should contain the lise binaries
  150.    PATH=$PATH:$LISEPRG              PATH ADD LISE:
  151.  
  152. b. compiling
  153.  
  154.    for the first examples, you can use the script
  155.    "mklise" to compile individual files.
  156.    (e.g. "mklise ash")
  157.    To compile the whole package use the script "mkall".
  158.    In the Amiga Version the "Tekamiga" needs to be compiled using
  159.    "mktek" and you will need to have the "mdllib.*" from my MDL
  160.    package for the Amiga. Since most of my Amiga scripts are using
  161.    the CShell, the scripts are named "mklise.sh" and "mkall.sh".
  162.  
  163. c. installing binaries
  164.  
  165.    you should copy the binaries from $LISEPRG/str to /usr/bin
  166.    (AMIGA: "LISE:str" to "c:")
  167.    and the binaries from $LISEPRG/fit to $LISEPRG.
  168.    (AMIGA: "LISE:fit" to "LISE:")
  169.  
  170. d. testing graphics
  171.  
  172.    On UNIX systems you should first try to open a tektronix
  173.    screen with "(xterm -t)&". Then try to start the "tekdaemon"
  174.    from within this tektronix window.
  175.    Now you can go back to your ASCII terminal emulation and
  176.    try to generate a test spectrum with
  177.   scalc "s1[0:127]=sin(0.1*lin)"
  178.    NOTE: the double quotes are essential and do not surround the
  179.    "=" operator with blanks !
  180.    After this try to display this spectrum with
  181.   ash s1 -pag -v
  182.    If this fails, try to compile "vect" and "point".
  183.    Try to draw a vector with
  184.   vect 100 100 2000 2000
  185.    Normally, all graphic routines should open the Tektronix
  186.    emulation automatically.
  187.    Use "rmtek" to close the Tektronix window.
  188.    Try to use "ash" again.
  189.    If this fails, you must modify the file "gfx.h"
  190.  
  191. e. environmental settings
  192.  
  193.    As mentioned above, the variable $LISEPRG must be set
  194.    to the lise executable path and this Path must also
  195.    be included in the normal PATH variable.
  196.    There is one optional environment variable:
  197.    MAXSPCLEN   contains the maximum spectra array length
  198.    On Amiga Computers this variable should be set using
  199.    the supplied LISESET command (LISESET MAXSPCLEN=32768)
  200.    since programs compiled under MANX are looking for the
  201.    ARP/MANX style variables and those compiled under SAS or GNU
  202.    are looking for the Amiga style ENV: variables !
  203.    You should modify the ".login" and ".profile" files
  204.    and also the X11 startup files !
  205.    The Vectorbuffer size should be adjusted in Aux_Config !
  206.  
  207. f. cleaning up pipes
  208.  
  209.    Sometimes it may happen, that no Tekwindow opens up
  210.    after an "ash" command. In this case try to remove the
  211.    graphics communication channels "/tmp/tek.pipe*"
  212.    The exact name is defined in your "Aux_Config" file.
  213.  
  214. g. getting help
  215.  
  216.    All LISE functions will return a small help message about
  217.    the available options if you specify the "-h" or "-help"
  218.    option
  219.  
  220.  
  221. V. about Amiga Compilers
  222. ------------------------
  223.  
  224. I am using Aztec (MANX) C 5.0 for most of the programms, except
  225. for the multiparameter fits. The multiparameter fit routines
  226. (fit.c, fitfn*.c) are compiled using Lattice C 5.0
  227. In general, all Programms can be compiled under both compilers,
  228. but you should supply the #defines SAS or MANX.
  229. You can mix executables from both compilers without problems.
  230. In general there are two handicaps:
  231. 1. MANX is not able to handle large static arrays !
  232. 2. SAS generates instable code in some cases !
  233.    (even worse with SAS 6.0 !)
  234. In Future I want to switch over to GnuC.
  235.  
  236. VI. Update info 2.0
  237. -------------------
  238.  
  239. 1. Reason for this Update
  240.    This Update is mainly a "graphics" update. I included
  241.    the Hershey vectorfonts and increased the internal Vector
  242.    resolution. There are also some minor changes to
  243.    the ASH command (options -rx -ry -cn -y% -x%).
  244.    The entries in Aux_Config have been changed drastic.
  245.    The JCAMPIO command has been added.
  246. 2. What has not been done (even if stated in LISE.DOC !)
  247.    I have not had the time to switch over to GNU C
  248.    (shame on me !)
  249.    The LISE portable floating point format must be tested and
  250.    is not included in this version !
  251.    Color and line style support are left for the next release.
  252.    The JCAMP support is just a quick hack
  253.  
  254. VII. mini LISE
  255. --------------
  256.  
  257. the mini LISE is specially compiled for small Amigas and must be
  258. considered as a DEMO Version.
  259. Restrictions:
  260. 1. Spectralength is limited to 2048 data points
  261.    (may be adjusted using "LISESET MAXSPCLEN=4096")
  262. 2. The vector buffer is reduced to 128k and the
  263.    primary font is set to litt.chr
  264.    (may be adjusted in Aux_Config)
  265. 3. the general multiparameter fit is not included
  266. 4. sources are not included
  267.  
  268. Generating the demo Disk:
  269. put a blank, formatted Disk in drive df0:
  270. find the LHA or LHARC or LZ command
  271. type
  272.  CD df0:
  273.  LZ e MINILISE.LHA
  274. or
  275.  LHARC e MINILISE.LHA
  276. or
  277.  LHA e MINILISE.LHA
  278.  
  279. (If you have a Harddisk and enough free space you should
  280.  create a directory on this Harddisk for LISE and make the
  281.  installation there)
  282.  
  283. Starting the demo:
  284. Boot from a normal Workbench Disk
  285. Insert the MINILISE Disk in a second drive if possible
  286. open the Disk icon.
  287. open the MINILISE Drawer
  288. Double click on the Demo icon
  289. DO NOT EXPECT THE SPECTRA DISPLAY TO RUN IN ONLY 1MB RAM !
  290. If you are really low on memory, try to avoid all residents,
  291. do not LOADWB, Open a new shell instead.
  292. Uncomment the line
  293. ; lise:LISESET MAXSPCLEN=1024
  294. in DEMO.BAT
  295. Edit Aux_Config and set the Vectorbuffer to 0 (now 128000)
  296. Use only NTSC HIRES NOLACE (640x200) mode
  297. type FROM A SHELL:
  298. > stack 32000
  299. > cd df1:MINILISE
  300. > execute demo.bat
  301.  
  302. On 68000 Systems with WB 1.3 you may have trouble (=GURU)
  303. to start the TekAmiga window from the script after using LISESET
  304. (Don't know why...) Open a shell and try to start Tekamiga
  305. separately first. If this went well, close the TekAmiga window
  306. and try to execute the batch file again.
  307. The funny thing is, that this only happens in the combination
  308. 68000 + WB 1.3 (Don't come up with WB 1.2 !)
  309. 68030/40 + WB 1.3 or 68000 + WB 3.0 works perfectly !
  310. May be this is a bug in MANX C, but TekAmiga compiled under SAS
  311. didn't display any characters...
  312.  
  313. VIII. Post Scriptum
  314. ------------------
  315.  
  316. If you hear about a vacant permanent position for a Physicist (PHD)
  317. and Computerfreak, preferably in Europe, please let me know.
  318. Rainer Kowallik
  319. Eisackstr. 14
  320. 1000 Berlin 62
  321. Germany
  322.  
  323. EAN: kowallik@vax.hmi.dbp.de
  324.